SGI Freeware 1999 August

home *** CD-ROM | disk | FTP | other *** search

/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_html2ps.idb / usr / freeware / catman / u_man / cat1 / html2ps.Z / html2ps

Wrap

Text File | 1999-01-26 | 16.5 KB | 397 lines

hhhhttttmmmmllll2222ppppssss((((1111)))) AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777)))) hhhhttttmmmmllll2222ppppssss((((1111)))) NNNNAAAAMMMMEEEE html2ps - convert HTML to PostScript SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS hhhhttttmmmmllll2222ppppssss [ ----2222ccccddddDDDDFFFFgggghhhhHHHHLLLLnnnnOOOORRRRTTTTuuuuUUUUvvvv ] [ ----bbbb _U_R_L ] [ ----CCCC _s_t_r_i_n_g ] [ ----eeee _e_n_c_o_d_i_n_g ] [ ----ffff _f_i_l_e[:_f_i_l_e[:...]] ] [ ----iiii _n_u_m ] [ ----llll _l_a_n_g ] [ ----mmmm _n_u_m ] [ ----NNNN _n_u_m ] [ ----oooo _f_i_l_e ] [ ----rrrr _p_a_t_h ] [ ----ssss _n_u_m ] [ ----SSSS _s_t_r_i_n_g ] [ ----WWWW _s_t_r_i_n_g ] [ ----xxxx _n_u_m ] [ _U_R_L|_f_i_l_e ] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The program hhhhttttmmmmllll2222ppppssss converts HTML to PostScript. The HTML code can be retrieved from one or more URL:s or local files, specified as parameters on the command line. If no parameter is given, html2ps reads from standard input. Note: To avoid unnecessary network traffic, one can rebuild an already generated PostScript file with new options. This is done by running html2ps with the new options, and with the old PostScript file as input (not applicable for all options). OOOOPPPPTTTTIIIIOOOONNNNSSSS All options have a short (case sensitive), and a long (case insensitive) form. ----2222 --------ttttwwwwoooouuuupppp Two column (2-up) output. The default is one column per page. ----bbbb _U_R_L --------bbbbaaaasssseeee _U_R_L Use _U_R_L as a base to expand relative references for in-line images. This is useful if you have downloaded a document to a local file. The _U_R_L should then be the _U_R_L of the original document. ----cccc --------cccchhhheeeecccckkkk Check the syntax of the HTML file (using an external syntax checker). The default is to not make a syntax check. ----CCCC _s_t_r_i_n_g --------ttttoooocccc _s_t_r_i_n_g Generate a table of contents (ToC). The value should be a string consisting of one of the letters 'f', 'h', or 't', optionally combined with the letter 'b': bbbb The ToC will be printed first. This requires that Ghostscript is installed. ffff The ToC will be generated from the links in the converted document. hhhh The ToC will be generated from headings and titles in the converted documents. Note that if the document author for some strange reason has chosen Page 1 (printed 12/10/98) hhhhttttmmmmllll2222ppppssss((((1111)))) AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777)))) hhhhttttmmmmllll2222ppppssss((((1111)))) to use some other means to represent the headings than the HTML elements H1,...,H6, you are out of luck! tttt The ToC will be generated from links having the attribute rev=TOC in the converted document. ----dddd --------ddddeeeebbbbuuuugggg Generate debugging information. You should always use this option when reporting problems with html2ps. ----DDDD --------DDDDSSSSCCCC Generate DSC compliant PostScript. This requires Ghostscript and can take quite some time to do. Note that a PostScript file generated with this option cannot be used as input to html2ps for reformatting later. ----eeee _e_n_c_o_d_i_n_g --------eeeennnnccccooooddddiiiinnnngggg _e_n_c_o_d_i_n_g The document encoding. Currently recognized values are ISO-8859-1, EUC-JP, SHIFT-JIS, and ISO-2022-JP (other EUC-xx encodings may also work). The default is ISO- 8859-1. ----ffff _f_i_l_e[:_f_i_l_e[:...]] --------rrrrccccffffiiiilllleeee _f_i_l_e[:_f_i_l_e[:...]] A colon separated list of configuration file names to use instead of the default personal configuration file $HOME/.html2psrc. Definitions made in one file override definitions in previous files (the last file in the list has highest precedence). An empty file name (as in ':file', 'file1::file3', or 'file:') will expand to the default personal file. The environment variable HTML2PSPATH is used to specify the directories where to search for these files. (Note: this is only supposed to be used on the command line, not in a configuration file.) ----FFFF --------ffffrrrraaaammmmeeee Draw a frame around the text on each page. The default is to not draw a frame. ----gggg --------ggggrrrraaaayyyyssssccccaaaalllleeee Convert colour images to grayscale images. Note that the PostScript file will be smaller when the images are converted to grayscale. The default is to generate colour images. ----hhhh --------hhhheeeellllpppp Show usage information. ----HHHH --------hhhhyyyypppphhhheeeennnnaaaatttteeee Hyphenate the text. This requires TeX hyphenation pattern files. Page 2 (printed 12/10/98) hhhhttttmmmmllll2222ppppssss((((1111)))) AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777)))) hhhhttttmmmmllll2222ppppssss((((1111)))) ----iiii _n_u_m --------ssssccccaaaalllleeeeiiiimmmmaaaaggggeeee _n_u_m Scale in-line images with a factor _n_u_m The default is 1. ----llll _l_a_n_g --------llllaaaannnngggguuuuaaaaggggeeee _l_a_n_g Specifies the language of the document (overrides an eventual LANG attribute of the BODY element). The language should be given according to RFC1766 (ftp://ftp.nordu.net/rfc/rfc1766.txt) and ISO 639 (http://www.sil.org/sgml/iso639a.html). ----LLLL --------llllaaaannnnddddssssccccaaaappppeeee Generate code for printing in landscape mode. The default is portrait mode. ----mmmm _n_u_m --------ssssccccaaaalllleeeemmmmaaaatttthhhh _n_u_m Scale mathematical formulas with a factor _n_u_m The default is 1. ----nnnn --------nnnnuuuummmmbbbbeeeerrrr Insert page numbers. The default is to not number the pages. ----NNNN _n_u_m --------ssssttttaaaarrrrttttnnnnoooo _n_u_m Specifies the starting page number, the default is 1. ----oooo _f_i_l_e --------oooouuuuttttppppuuuutttt _f_i_l_e Write the PostScript code to _f_i_l_e. The default is to write to standard output. ----OOOO --------oooorrrriiiiggggiiiinnnnaaaallll Use PostScript original images if they exist. For example, if a document contains an image figure.gif, and an encapsulated PostScript file named figure.ps exists in the same directory, that file will be use instead. This only work for documents read as local files. Note: if the PostScript file is large or contains bitmap images, this must be combined with the -D option. In HTML 4.0 this can be achieved in a much better way with: <OBJECT data="figure.ps" type="application/postscript"> <OBJECT data="figure.gif" type="image/gif"> <PRE>[Maybe some ASCII art for text browsers]</PRE> </OBJECT> </OBJECT> ----rrrr _p_a_t_h --------rrrroooooooottttddddiiiirrrr _p_a_t_h When a document is read from a local file, this value specifies a base directory for resolving relative links starting with "/". Typically, this should be the directory where your web server's home page resides. Page 3 (printed 12/10/98) hhhhttttmmmmllll2222ppppssss((((1111)))) AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777)))) hhhhttttmmmmllll2222ppppssss((((1111)))) ----RRRR --------xxxxrrrreeeeffff Insert cross references at every link to within the set of converted documents. ----ssss _n_u_m --------ssssccccaaaalllleeeeddddoooocccc _n_u_m Scale the entire document with a factor _n_u_m The default is 1. ----SSSS _s_t_r_i_n_g --------ssssttttyyyylllleeee _s_t_r_i_n_g This option complements/overrides definitions made in the configuration files. The _s_t_r_i_n_g must follow the configuration file syntax. (Note: this is only supposed to be used on the command line, not in a configuration file.) ----TTTT --------tttteeeexxxxtttt Text mode, ignore images. The default is to include the images. ----uuuu --------uuuunnnnddddeeeerrrrlllliiiinnnneeee Underline text that constitutes a hypertext link. The default is to not underline. ----UUUU --------ccccoooolllloooouuuurrrr Produce colour output for text and background, when specified. The default is black text on white background (mnemonic: coloUr ;-). ----vvvv --------vvvveeeerrrrssssiiiioooonnnn Print information about the current version of html2ps. ----WWWW _s_t_r_i_n_g --------wwwweeeebbbb _s_t_r_i_n_g Process a web of documents by recursively retrieve and convert documents that are referenced with hyperlinks. When dealing with remote documents it will of course be necessary to impose restrictions, to avoid downloading the entire web... The value should be a string consisting of one of the letters 'a', 'b', 'l', 'r', or 's', optionally combined with a combination of the letters 'p', 'L', and a positive integer: aaaa Follow all links. bbbb Follow only links to within the same directory, or below, as the start document. llll Follow only links specified with "<LINK rel=NEXT>" in the document. pppp Prompt for each remote document. This mode will automatically be entered after the first 50 documents. rrrr Follow only relative links. ssss Follow only links to within the same server as the start document. Page 4 (printed 12/10/98) hhhhttttmmmmllll2222ppppssss((((1111)))) AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777)))) hhhhttttmmmmllll2222ppppssss((((1111)))) LLLL With this option, the order in which the documents are processed will be: first all top level documents, then the documents linked to from these etc. For example, if the document A has links to B and C, and B has a link to D, the order will be A-B-C-D. By default, each document will be followed by the first document it links to etc; so the default order for the example is A-B-D-C. #### A positive integer giving the number of recursive levels. The default is 4 (when the option is present). ----xxxx _n_u_m --------dddduuuupppplllleeeexxxx _n_u_m Generate postscript code for single or double sided printing. No default, valid values are: 0000 Single sided. 1111 Double sided. 2222 Double sided, opposite page reversed (tumble mode). BBBBUUUUGGGGSSSS The following bugs are with respect to HTML 3.2 - at the time of writing the current W3C Recommendation for HTML. The support for HTML 4.0 is described in another section of this document. The IMG attributes ALIGN=LEFT and ALIGN=RIGHT are not recognized. This means that text flow around images does not work. Also, the IMG attributes WIDTH and HEIGHT are ignored. The TYPE attribute in unordered lists UL is not supported. A few deviations from the TABLE element as specified in HTML 3.2: It is not possible to set the border width of a table. The WIDTH and HEIGHT attributes of the TH and TD elements does not work correctly (in my opinion, these attributes are bugs in the HTML specification itself!). The CELLSPACING attribute is not implemented as described in the specification; instead the value of the CELLPADDING attribute is increased by half the value of CELLSPACING. Rendering HTML tables well is a non-trivial task. For "real" tables, that is representation of tabular data, html2ps usually generates reasonably good output. When tables are used for layout purposes, the result varies from good to useless. This is because a table cell is never broken across pages. So if a table contains a cell with a lot of content, the entire table may have to be scaled down in size in order to make this cell fit on a single page. Sometimes this may even result in unreadable output. Page 5 (printed 12/10/98) hhhhttttmmmmllll2222ppppssss((((1111)))) AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777)))) hhhhttttmmmmllll2222ppppssss((((1111)))) Page breaks are occasionally done in bad places: for example directly after a (long) heading, and before the last line in a paragraph. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT HTML2PSPATH This variable specifies the directories to search for configuration files. It should be a colon separated list of directory names. Use a dot '.' to denote the current directory. An empty directory name (as in ':dir', 'dir1::dir3', or 'dir:') will expand to the directory where the global configuration file is. The default value is '.:', that is: search the current directory first, and then the global one. FFFFIIIILLLLEEEESSSS /usr/freeware/lib/html2ps/html2psrc Global configuration file. See html2psrc(5). $HOME/.html2psrc User configuration file. See html2psrc(5). /usr/freeware/lib/html2ps/html2ps.html Documentation for html2ps. SSSSEEEEEEEE AAAALLLLSSSSOOOO html2psrc(5), perl(1), setlocale(3), strftime(3), weblint(1) VVVVEEEERRRRSSSSIIIIOOOONNNN This manpage describes html2ps version 1.0 beta1. AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY http://www.tdb.uu.se/~jan/html2ps.html ftp://ftp.tdb.uu.se/pub/WWW/html2ps/ AAAAUUUUTTTTHHHHOOOORRRR Jan Karrman (jan@tdb.uu.se) Page 6 (printed 12/10/98)